Signal sensed
CPAP therapypressure · flow · leak · device events
CPAPDex senses one signal — the night of CPAP therapy — by decoding the machine’s own EDF/EDF+ files. It carries the suite’s one genuinely new capability: a pure-JS EDF binary reader. It is a working scaffold, built layer-clean from day one.
Read the suite as a reflex arc: receptors → relay → integration → insight. CPAPDex is an afferent receptor — it does exactly one transduction well and reports inward. It never reaches into another node; cross-signal work happens only through the Ganglior export, consumed by the Integrator.
CPAPDex is built from external *.js files referenced by CPAPDex.src.html and bundled to a standalone CPAPDex.html. Dependencies point downhill only — UI → DSP → Core — and each file owns exactly one job. Edit the .js + .src.html, never the bundle; re-bundle after changes.
buildHash provenance stamp). 100% local.crossNight() stats stay per-node).tMs (local civil time encoded as if UTC) and reads it back with getUTC* — so the recording reads identically in any viewer’s timezone, and two devices recording the same minute land on the same tMs. parseTimestamp is duplicated locally by design.The pipeline is the same shape across the suite: ingest → parse on the canonical clock → compute in DSP → grade & render in UI → emit onto the bus. No number is computed in the render layer; it asks DSP for the value and the registry for how to show it.
A night is several EDF files (BRP/PLD/SA2/EVE/CSL). They’re clustered into sessions by the filename timestamp prefix (YYYYMMDD_HHMMSS).
The pure-JS reader parses headers, decodes int16 samples to physical units, and reads EVE/CSL annotation TALs — entirely in-browser.
EDF carries local civil time with no zone → floating t0Ms via Date.UTC, offsetMin = null, read back with getUTC*.
Per-session metrics are computed (maskOn, the 14 manifest metrics), then merged and anchored into one night object.
Optionally upgrade with an OxyDex/ECGDex export, then emit device-scored apnea/leak events onto Ganglior.
Every metric CPAPDex surfaces carries an evidence grade — a non-hue badge whose fill is the confidence ladder: solid bullseye for a raw reading, down to a dashed ring for a friendly estimate. A measurement and a projection must never look alike. Grades live in cpapdex-registry.js, the one source of truth.
Honesty is architectural: a guess is never dressed as a measurement, a missing value stays null rather than fabricated, and confidence is kept separate from signal quality. The node-specific caveats:
CPAPDex is a faithful starting point, not a finished node. The EDF reader and metrics are real; some longitudinal pieces (e.g. compliance) are defined but still maturing.
The CPAP’s own oximeter channel is frequently not connected. Co-importing an OxyDex night supplies real ODI/T90 — clearly labelled as external.
The AirSense’s own EVE-scored apneas are the highest evidence tier — CPAPDex trusts the device’s scoring over any re-derivation.
Unlike the older nodes, CPAPDex was built with edf / dsp / render / fusion separated from day one — the target architecture, adopted forward.
CPAPDex is one self-contained file. Open CPAPDex.html in any browser — online, offline, or from file://. Nothing installs, nothing phones home.
Drag a ResMed AirSense export (edf / edf+ binary) onto the upload zone. It’s read in-browser and turned into metrics on your device alone.
Start in Core for the headline readiness and a plain-language line. Step up to Advanced for full tables and charts, or Research for composites and the full dump. Each metric’s evidence dot tells you how far to trust it.
Export a ganglior.node-export JSON to feed the Integrator, or to upgrade a peer node’s read. Events carry a wall-clock t; consumers reconstruct absolute time from the recording start.
Edit the cpapdex-*.js files or CPAPDex.src.html — never the bundled CPAPDex.html — then re-bundle. Run Dex-Test-Suite.html until all-green, and verify-provenance.html after re-bundling.